feat: Add command for adding schedules to subscriptions #707

calvin-codecov · 2026-02-10T22:56:07Z

Adds general command for the team to run to bulk add subscription schedules for Owners. It will procure the matching owners based on the arguments and process each.

Takes these as user provided arguments:

end date
target plan (if it is switching plans)
dry-run
renew-date-gte
renew-date-lte
owner ids array allowlist
current plan that we want to filter owners by
owner ids array exclude list
limit for # owners to run for
ownerid cursor for batching

Handles multiple scenarios for each owner

if this subscription already has had this applied and the dates match up, skip
if the dates don't match up, update the date
if this subscription has a unrelated schedule, add to the schelude
create a subscription schedule if it doesn't have a schedule already

The command will return a summary of what happened and the owner id for the last acted upon owner.

PR also adds to the modify_subscription webhook handler logic to reapply the schedule if the subscription encounters an upgrade after the command has been run as upgrades will release schedules.

Note

Medium Risk
Touches Stripe subscription upgrade and scheduling logic; mistakes could incorrectly cancel, extend, or drop cancellation schedules for paying customers. Changes are test-covered but interact with live Stripe state and metadata conventions.

Overview
Adds a new apply_subscription_schedules Django management command to bulk create/update Stripe SubscriptionSchedules that cancel subscriptions at a specified end date, with filters (renewal date, plan, owner allow/deny lists), cursor-based batching, and a --dry-run mode.

Introduces shared schedule task_signature constants and reuses a new helper (_create_end_date_schedule) to make schedule creation idempotent and distinguish schedules created by the command/webhook. Updates StripeService.modify_subscription upgrade flow to detect and preserve prior cancellation end dates when releasing schedules (recreate after successful upgrade, and restore on upgrade failure). Adds comprehensive tests for the command and the new upgrade/schedule-recreation behavior.

^{Written by Cursor Bugbot for commit f36f356. This will update automatically on new commits. Configure here.}

apps/codecov-api/billing/management/commands/apply_subscription_schedules.py

apps/codecov-api/services/billing.py

apps/codecov-api/billing/management/commands/apply_subscription_schedules.py

apps/codecov-api/services/billing.py

apps/codecov-api/billing/management/commands/apply_subscription_schedules.py

apps/codecov-api/services/billing.py

calvin-codecov · 2026-02-11T18:51:28Z

apps/codecov-api/services/billing.py

-        #   If the user is not in a schedule, update immediately
-        #   If the user is in a schedule, update the existing schedule


This comment was actually already no longer correct and had not been updated. This handler has been releasing the existing schedule for a long time.

apps/codecov-api/billing/management/commands/apply_subscription_schedules.py

apps/codecov-api/services/tests/test_billing.py

…ures

sentry · 2026-02-12T18:00:43Z

Codecov Report

❌ Patch coverage is 78.46154% with 42 lines in your changes missing coverage. Please review.
✅ Project coverage is 92.20%. Comparing base (cf5ee52) to head (f36f356).
✅ All tests successful. No failed tests found.

Files with missing lines	Patch %	Lines
...anagement/commands/apply_subscription_schedules.py	77.51%	38 Missing ⚠️
apps/codecov-api/services/billing.py	83.33%	4 Missing ⚠️

❌ Your patch check has failed because the patch coverage (78.46%) is below the target coverage (90.00%). You can increase the patch coverage or adjust the target coverage.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #707      +/-   ##
==========================================
- Coverage   92.25%   92.20%   -0.06%     
==========================================
  Files        1302     1303       +1     
  Lines       47854    48047     +193     
  Branches     1628     1628              
==========================================
+ Hits        44149    44300     +151     
- Misses       3396     3438      +42     
  Partials      309      309

Flag	Coverage Δ
apiunit	`96.16% <78.46%> (-0.20%)`	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

codecov-notifications · 2026-02-12T18:00:53Z

Codecov Report

❌ Patch coverage is 78.46154% with 42 lines in your changes missing coverage. Please review.
✅ All tests successful. No failed tests found.

Files with missing lines	Patch %	Lines
...anagement/commands/apply_subscription_schedules.py	77.51%	38 Missing ⚠️
apps/codecov-api/services/billing.py	83.33%	4 Missing ⚠️

❌ Your patch check has failed because the patch coverage (78.46%) is below the target coverage (90.00%). You can increase the patch coverage or adjust the target coverage.

📢 Thoughts on this report? Let us know!

cursor

Cursor Bugbot has reviewed your changes and found 2 potential issues.

^{Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.}

cursor · 2026-02-12T18:06:55Z

apps/codecov-api/services/billing.py

+                    phase1_quantity=desired_plan["quantity"],
+                    subscription=subscription,
+                    task_signature=WEBHOOK_CANCELLATION_TASK_SIGNATURE,
+                )


Schedule recreation failure prevents DB plan update

Medium Severity

_create_end_date_schedule is called between the successful Subscription.modify and plan_service.update_plan. If the schedule recreation fails (Stripe API error, network issue), the exception propagates, skipping the DB update. This leaves the subscription upgraded in Stripe but the owner's plan stale in the database, and the previously released cancellation schedule is permanently lost.

Additional Locations (1)

apps/codecov-api/services/billing.py#L459-L465

cursor · 2026-02-12T18:06:55Z

apps/codecov-api/services/billing.py

+)
+from billing.management.commands.apply_subscription_schedules import (
+    _create_end_date_schedule,
+)


Shared utility function lives inside management command

Low Severity

_create_end_date_schedule is defined as a private function (underscore prefix) inside a management command module but is imported by production service code in billing.py. This inverts the expected dependency direction — services typically feed management commands, not vice versa. The function belongs in a shared module like billing/utils.py or billing/services.py.

Additional Locations (1)

apps/codecov-api/billing/management/commands/apply_subscription_schedules.py#L31-L40

sentry bot reviewed Feb 10, 2026

View reviewed changes

cursor bot reviewed Feb 10, 2026

View reviewed changes

calvin-codecov force-pushed the cy/stripe_yearly_sub_sched_action branch from a1aafd4 to 7e2f900 Compare February 10, 2026 23:20

calvin-codecov changed the title ~~feat: Add command for adding end dates to annual plans~~ feat: Add command for adding schedules to subscriptions Feb 10, 2026

sentry bot reviewed Feb 10, 2026

View reviewed changes

apps/codecov-api/billing/management/commands/apply_subscription_schedules.py Outdated Show resolved Hide resolved

cursor bot reviewed Feb 11, 2026

View reviewed changes

sentry bot reviewed Feb 11, 2026

View reviewed changes

apps/codecov-api/services/billing.py Show resolved Hide resolved

cursor bot reviewed Feb 11, 2026

View reviewed changes

apps/codecov-api/billing/management/commands/apply_subscription_schedules.py Outdated Show resolved Hide resolved

apps/codecov-api/services/billing.py Show resolved Hide resolved

apps/codecov-api/services/billing.py Outdated Show resolved Hide resolved

calvin-codecov commented Feb 11, 2026

View reviewed changes

cursor bot reviewed Feb 11, 2026

View reviewed changes

apps/codecov-api/billing/management/commands/apply_subscription_schedules.py Show resolved Hide resolved

apps/codecov-api/services/tests/test_billing.py Outdated Show resolved Hide resolved

calvin-codecov added 5 commits February 12, 2026 09:52

feat: Add command for adding schedules to subscriptions

5f0d863

fix: Address bot comments

ec88211

ref: Change stripe modify call signature for consistency

dd8c188

ref: Consolidate schedule creation and recreate end schedule for fail…

21ad3ec

…ures

test: Modify billing.py tests

f36f356

calvin-codecov force-pushed the cy/stripe_yearly_sub_sched_action branch from 938002c to f36f356 Compare February 12, 2026 17:52

cursor bot reviewed Feb 12, 2026

View reviewed changes

		# If the user is not in a schedule, update immediately
		# If the user is in a schedule, update the existing schedule

feat: Add command for adding schedules to subscriptions #707

Are you sure you want to change the base?

feat: Add command for adding schedules to subscriptions #707

Uh oh!

Conversation

calvin-codecov commented Feb 10, 2026 • edited by cursor bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

calvin-codecov Feb 11, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

sentry bot commented Feb 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

codecov-notifications bot commented Feb 12, 2026

Codecov Report

Uh oh!

cursor bot left a comment

Choose a reason for hiding this comment

Uh oh!

cursor bot Feb 12, 2026

Choose a reason for hiding this comment

Schedule recreation failure prevents DB plan update

Uh oh!

cursor bot Feb 12, 2026

Choose a reason for hiding this comment

Shared utility function lives inside management command

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

calvin-codecov commented Feb 10, 2026 •

edited by cursor bot

Loading

sentry bot commented Feb 12, 2026 •

edited

Loading